home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 029a / scopy201.zip / SCOPY.DOC < prev    next >
Text File  |  1991-03-13  |  12KB  |  337 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                  SCOPY
  7.  
  8.  
  9.       DISKETTE to FILE / FILE to DISKETTE / FILE TO FILE
  10.                COPY and ARCHIVE UTILITY
  11.  
  12.                               Written by
  13.                              Craig Gaumer
  14.                                   and
  15.                               Ed Bachman
  16.  
  17.  
  18.                         For C.E.Gaumer Software
  19.                              P.O. Box 384
  20.                      Laurys Station, PA 18059-0384
  21.  
  22.                    (C) 1990,1991 All Rights Reserved
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                    SHAREWARE
  30.  
  31.         This version of SCOPY is ShareWare.  Feel free to copy and
  32. distribute the Shareware version of the program under the conditions
  33. that it remain unaltered and this DOC file be distributed with SCOPY.
  34.     If you use SCOPY beyond a reasonable trial period registration
  35. is required.  The Registered Version is available from C.E. Gaumer
  36. Software.  See REGISTRATION FORM at the end of this document or print
  37. the form SCOPY.REG for a registraion form.  Note that use in a
  38. Corporate, Agency or Government environment REQUIRES a site license.
  39.  
  40.  
  41.                               DISCLAIMER
  42.  
  43.         It is the sole resposibility of the user to determine the
  44. suitability and fitness of SCOPY for the user's particular needs, uses
  45. and hardware.  C.E. Gaumer Software assumes no responsibility for any
  46. difficulties, problems or loss of data resulting from the use of SCOPY,
  47. even if C.E. Gaumer Software has been informed of the possibility of
  48. such difficulties, problems or losses.
  49.  
  50.  
  51.                            GENERAL OVERVIEW
  52.  
  53.         The general purpose of SCOPY is to copy a diskette into a file
  54. and back.  The final diskette is a reproduction of the original diskette
  55. as if it had been made with DISKCOPY.  This is useful if you have a set
  56. of diskettes on which the files must reside on the proper diskette
  57. and/or in the proper subdirectory for an install program or for indexing
  58. or other purposes.  Since SCOPY can now do LZ compression and the SCOPY
  59. file contains its own CRC checksum, SCOPY's usefulness for archiving and
  60. modem transfers has been greatly enhanced.  Also, since the file can
  61. reside on the hard drive, memory size is not a limiting factor so a
  62. DISKCOPY type operation can be done in a single pass, even in the
  63. larger diskette formats.  For this type of operation SCOPY to a ramdisk
  64. can speed execution.
  65.  
  66.  
  67.  
  68.              USE OF SCOPY 2.01 WITH OLDER SCOPY VERSIONS
  69.  
  70.         SCOPY, as in previous releases, is 100% backward compatible.
  71. Any SCOPY file created with an older version of SCOPY can be properly
  72. read by SCOPY 2.01.  SCOPY 2.01 files created without compression can be
  73. read by the older registered versions of SCOPY, but the older version
  74. will not be able to verify the CRC checksum in the file.  If LZ
  75. compression is used to create a SCOPY file older versions of SCOPY
  76. will report that the resultant file is "NOT A SCOPY FILE".
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.                           USAGE and SWITCHES
  84.  
  85.         There are four different sets of syntax for SCOPY depending on
  86. the source and destination of the copy or the information requested.
  87. These will be discussed individually.  Typing SCOPY with no parameters
  88. at all will show a help screen for ready reference.
  89.  
  90.     The general rule is: SCOPY Source Destination [Switches]
  91.  
  92. Although multiple switches are shown in this document using a slash to
  93. precede each switch all the switches on the command line may be grouped.
  94. The switches are also NOT case sensitive (i.e. SCOPY A: TEST /O /R is
  95. identical to SCOPY A: TEST /OR and scopy a: test /o /r) When SCOPY
  96. reads or writes a file the default extender is .SCP but the user may
  97. supply a different extender or, by typing the period, indicate to SCOPY
  98. not to use any extender.
  99.  
  100.  
  101.  
  102.  
  103.                   SCOPYING FROM A DISKETTE TO A FILE
  104.  
  105. The proper syntax is:
  106.  
  107. [Drive][Path]SCOPY Src_Drive: [Drive:][Path]Dest_Filename[.Ext] [/O][/C][/R]
  108.  
  109. /O (Overwrite) causes no prompt if the destination file already exists
  110. /R (Remark) prompts the user for a comment to be included in the file
  111. /C (Compress) causes the destination file to be LZ compressed
  112.  
  113. Example:
  114.  
  115.     SCOPY A: C:\UTILITY\THISDISK /R
  116.  
  117. Would SCOPY the diskette in A to THISDISK.SCP in the UTILITY directory
  118. of drive C prompting the user for a remark to be included in the file.
  119. If the file THISDISK.SCP already existed the user would be prompted and
  120. asked permission to overwrite the existing file.
  121. (of course if C:\UTILITY is the current directory then
  122.  
  123.     SCOPY A: THIDISK /R
  124.  
  125. is identical to the above example)
  126.  
  127.  
  128.         Even without any switches SCOPY compresses the file slightly.
  129. This compression affects only sectors in which all the bytes of the
  130. sector are identical.  Even on a diskette with "0 bytes free" there is a
  131. good chance that there are unused sectors since the diskette space is
  132. usually alocatted in 2 sector clusters.  However erased files are not
  133. compressed because any sectors which contain data are not compressed
  134. even if that data is unused by any file.  This often happens on a
  135. diskette where files have been erased.
  136.  
  137.         The /C switch causes SCOPY to create the file using the LZ
  138. compression method.  This results in a higher level of compression but,
  139. of course, takes more time.  If the resultant SCOPY file is to be
  140. temporary (as when using SCOPY only to do one pass DISKCOPY or make
  141. multiple copies from a single disk read) then the /C switch should not
  142. be used.
  143.  
  144.         The diskette created with SCOPY is identical to the original.
  145. If the original was a boot disk the copy will be bootable.  If the
  146. original has files which could be unerased then the copy will also.
  147.  
  148.     When the /R switch is used the user is prompted for a remark to
  149. be included in the SCOPY file.  The remark is displayed when SCOPY
  150. accesses the file and can be written to the file SCOPYLBL.TXT when a
  151. diskette is created from the file (see SCOPYING FROM A FILE TO A
  152. DISKETTE below) The remark is limited to 128 characters in length.
  153. When SCOPYing multiple diskettes in one session the DOS command line
  154. keys (F3, the arrows, etc.) work when editing REMARKS after the first.
  155. The remark entry can also be redirected from a file using the DOS
  156. redirection operator on the command line.  The remark does not appear
  157. anywhere on the diskette(s) created from the SCOPY file.
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.                   GETTING INFORMATION ON A SCOPY FILE
  165.  
  166. The syntax for this is:
  167.  
  168. [Drive:][Path]SCOPY [Drive:][Path]Source_Filename[.Ext] [/V]
  169.  
  170. This displays information on a SCOPY file.
  171.  
  172.         The information about the original diskette is given along with the
  173. remark included in the file (if any). The compression level used by
  174. SCOPY when the file was created is shown if the file is compressed.
  175.  
  176.         The /V switch causes the data in the SCOPY file to be Verified
  177. using the CRC checksum and, if LZ compression was used, the LZ testing.
  178.  
  179. Example:
  180.  
  181.     SCOPY THISDISK /V
  182.  
  183. will show the type of diskette from which the file THISDISK.SCP was
  184. created and the remark, if any.  The file will be read and the CRC
  185. checksum verified since the /V switch is specified.
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.                   SCOPYING FROM A FILE TO A DISKETTE
  193.  
  194. [Drive:][Path]SCOPY [Drive:][Path]Src_Filename[.Ext] Dest_Drive:
  195. [/O][/N|F][/H][/R]
  196.  
  197. Where /O (Overwrite) causes no prompt if the diskette already contains data,
  198. /N (No format) causes the destination diskette not to be formatted and
  199. /F (Format) causes the destination diskette to be formatted.
  200. /H (Hi Density) forces setting up for formatting of a 360K diskette
  201.   in a 1.2 Meg drive where the presence of a 1.2 Meg Drive cannot be
  202.   automatically determined.
  203. /R (Remark) appends the remark, if any, in the SCOPY file, to a file
  204.    called SCOPYLBL.TXT in the current directory.
  205.  
  206.         The /O switch causes any existing data on the diskette to be
  207. overwritten without prompting the user.  Without the switch the
  208. diskette directory is read and permission is requested to overwrite if
  209. the diskette contains any data (even a volume name or hidden file).
  210. The /N switch causes the destination diskette NOT to be formatted and
  211. the /F switch forces the diskette to be formatted.  The default (used
  212. when neither /F or /N is used) is to check the diskette to see if it
  213. has the correct format and, if not, to format the diskette while
  214. writing the data.  Formatting is performed on a track by track basis
  215. and the data is written while the heads are on the track so the entire
  216. process (formatting and writing) is done in one pass of the heads
  217. across the diskette.  The /H switch is not normally required on AT
  218. class computers.  It tells SCOPY that a high density diskette drive is
  219. installed and a low density diskette is being created.  SCOPY can
  220. normally detect this automatically in AT class machines. The /H switch
  221. is only needed when formatting a 40 track diskette in a high density
  222. drive on a machine not capable of telling SCOPY that the drive is high
  223. density.  As a side note: SCOPY has the ability to format 1.44 Meg and
  224. 720K 3.5 inch diskettes to 360K, however, some 3.5 inch drives
  225. (including those in IBM PS/2's) are not able to read 360K 3.5
  226. inch diskettes.  SCOPY also will format 1.44 Meg diskettes to 720K but
  227. SCOPY will NOT format 720K diskettes (without the density hole) to 1.44
  228. Meg.  The /R switch appends the remark in the SCOPY file, if one
  229. exists, to the file SCOPYLBL.TXT in the current directory.  If the file
  230. SCOPYLBL.TXT does not exist it is created.  This feature was added at
  231. the request of a user so that the resultant SCOPYLBL.TXT file could be
  232. used to generate diskette labels.
  233. Example:
  234.     SCOPY THISDISK A: /O
  235.  
  236. Would check the diskette in drive A: and format it while writing the
  237. data from THISDISK.SCP.  If the diskette already contained data it
  238. would be overwritten without prompting the user (/O).
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.                    SCOPYING FROM ONE FILE TO ANOTHER
  247.  
  248. [Drive][Path]SCOPY [Drive:][Path]Src_Filename[.Ext] [Drive:][Path]
  249.             Dest_Filename[.Ext] [/O][/C][/R]
  250.  
  251.         This allow SCOPYing from one SCOPY file to another.  Useful for
  252. changing the remark or compression level or for adding the CRC
  253. checksum to older SCOPY files.
  254.  
  255.         The switches affect the destination file in the same way as they
  256. do in Diskette to File, except that if /R is NOT specified the remark is
  257. transferred intact from the source to the destination file.  If /R is
  258. specified the user is prompted for a remark in the normal manner.
  259.  
  260.  
  261.                                COMMENTS
  262.  
  263.         Any comments you have about SCOPY or suggestions for additions
  264. to future releases will be welcomed.
  265.  
  266.         Questions or comments may be addressed to the author at:
  267.  
  268.         C.E. Gaumer Software
  269.         P.O. Box 384
  270.         Laurys Station, PA 18059-0384
  271.  
  272.         If you are reporting a problem with SCOPY please include
  273. information on the Diskette SCOPY'd from and to, the type and make of
  274. diskette drives involved and the type and configuration of your system.
  275.         Thank You.
  276.  
  277.              TECHNICAL INFORMATION
  278.  
  279.     SCOPY, in its earlier versions, has been in use for over a
  280. year.  Hundreds of megabytes of SCOPY files are in use as archives of
  281. program diskettes and other files.
  282.  
  283.     SCOPY is written in C and compiled using Microsoft(R) C 6.0.
  284.  
  285.     SCOPY has been tested in a number of network environments and
  286. has functioned well in testing on 8088, 80286 and 80386 IBMs(R) and
  287. clones.
  288.  
  289.     SCOPY returns errorlevels which can be tested in batch file
  290. operations and which provide complete information on the success or
  291. failure of the requested operation.  A complete listing of the
  292. errorlevels returned by SCOPY is included in the documentation in the
  293. registered version.
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.                         SCOPY REGISTRATION FORM
  304.  
  305.  
  306.  
  307. Name:____________________________________________________
  308.  
  309.  
  310. Address:_________________________________________________
  311.  
  312.  
  313. City:__________________________State:______Zip:__________
  314.  
  315.  
  316. Diskette Type Requested:    5-1/4"_____       3-1/2"_____
  317.  
  318.  
  319. Number of copies requested:_________________
  320.  
  321.  
  322. Amount Enclosed:($20 per copy)$______________
  323.  
  324.  
  325. Send to:
  326.  
  327.         C.E.Gaumer Software
  328.         P.O. Box 384
  329.         Laurys Station, PA 18059-0384
  330.  
  331. Write for volume discounts or site licensing.
  332.  
  333. Thank You
  334.  
  335. Comments:
  336.  
  337.